home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.2 for Intel / NeXTSTEP 3.2 for Intel.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbmoretext.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.4 KB  |  51 lines
  1. .Na "dbmoretext"
  2. .mc |
  3. .Aa
  4. .Fu
  5. Send part of a text or image value to \*S.
  6. .Ih "text value, updating"
  7. .Ih "image value, updating"
  8. .Sy
  9. .Sf "RETCODE dbmoretext(dbproc, size, text)"
  10. .Sp "DBPROCESS" "*dbproc"
  11. .Sp "DBINT" "size"
  12. .Sp "BYTE" "*text"
  13. .Co
  14. .Bl
  15. This routine is used in conjunction with \f2dbwritetext()\f1
  16. to send a large SYBTEXT or SYBIMAGE value to \*S in the form
  17. of a number of smaller chunks.
  18. This is particularly useful with operating systems 
  19. unable to allocate extremely long data buffers.
  20. .Bl
  21. \f2dbmoretext()\f1 and \f2dbwritetext()\f1 are used in updates only, and serve to replace the
  22. \*N UPDATE statement.
  23. .Bl
  24. \f2dbsqlok()\f1 and \f2dbresults()\f1 must be called before the first call to 
  25. \f2dbmoretext()\f1 and after the last call to \f2dbmoretext()\f1.
  26. .Bl
  27. See the \f2dbwritetext()\f1 manual page for more information, including an example
  28. that uses \f2dbmoretext()\f1.
  29. .Bz
  30. .Pa
  31. .Pi dbproc
  32. A pointer to the DBPROCESS structure that provides the connection
  33. for a particular front-end/\*S process.  It contains all the
  34. information that \*L uses to manage communications and data between the
  35. front end and \*S.
  36. .Pi size
  37. The size, in bytes, of this particular part of the text or image value being sent to \*S.
  38. It is an error to send more text or image bytes to \*S than were specified in the
  39. call to \f2dbwritetext()\f1.
  40. .Pi text
  41. A pointer to the text or image portion to be written.
  42. .in -.375i
  43. .Re
  44. .br
  45. SUCCEED or FAIL.
  46. .Sa
  47. dbtxptr, 
  48. dbtxtimestamp,
  49. dbwritetext
  50. .mc
  51.